home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / mint095s.zoo / readme.1st < prev    next >
Text File  |  1992-08-02  |  4KB  |  91 lines
  1. MiNT is Not TOS: A Multitasking Operating System Extension for the Atari ST
  2.  
  3. Copyright 1990,1991,1992 Eric R. Smith. All rights reserved. See the file
  4. "copying" for conditions of redistribution.
  5.  
  6. MiNT COMES WITH ABSOLUTELY NO WARRANTY, NOR WILL I BE LIABLE FOR ANY
  7. DAMAGES INCURRED FROM THE USE OF IT. USE ENTIRELY AT YOUR OWN RISK!!!
  8. ---------------------------------------------------------------------
  9. OK, some of you don't want to read docs (even when there's a whole
  10. directory full of them). So here's the brief version of how to make
  11. MiNT run. For a list of new features in this version of MiNT, see the
  12. file "readme.new".
  13.  
  14. (1) put mint.prg in the AUTO folder of your boot disk. Make sure it's the
  15. last thing in the folder -- anything after MiNT won't run.
  16.  
  17. (2) copy toswin.acc, toswin.rsc, and toswin.cnf to the root directory of
  18. the boot disk. copy emacs.mnu to wherever you keep your EMACS editor (if
  19. you have one).
  20.  
  21. (3) reboot
  22.  
  23. Simple, huh? Now, there are some things you can do to customize your
  24. system:
  25.  
  26. (4) You can customize the way MiNT boots (for example, set what program
  27. should be run at boot time, or automatically set up symbolic links) by
  28. editing the file "mint.cnf" with an ordinary ASCII text editor.
  29.  
  30. (5) If you want MiNT to run something other than GEM, you can
  31. tell MiNT to do this by providing a line like:
  32.     INIT=c:\mintshel.ttp
  33. in mint.cnf; this tells MiNT to run "c:\mintshel.ttp" as its first
  34. process rather than GEM. Any non-GEM program should work as an
  35. INIT program. (mintshel.ttp is available with the MiNT utilities
  36. in the file "mntutl95.zoo").
  37.  
  38. (6) If you have TOS 1.2 or higher, you can install a new drive (drive
  39. U:) on the desktop. This has all other drives as subdirectories,
  40. plus some special subdirectories:
  41.     U:\DEV shows all BIOS devices available under MiNT
  42.     U:\PROC shows all processes that are active; deleting
  43.         a process will (usually) kill it.
  44.  
  45. (7) While MiNT is running, there are some special keys available:
  46.  
  47. CTRL-ALT-C: kills all processes that are reading from/writing to the
  48.     screen. Useful for getting out of hung programs.
  49. CTRL-ALT-\ or CTRL-ALT-UNDO: similar to CTRL-ALT-C, but somewhat more
  50.     fatal (fewer programs choose to catch the signal these keys
  51.     raise)
  52. CTRL-ALT-DEL: resets the computer, as in TOS 1.4 and higher
  53. CTRL-ALT-F1: raises the "debug level" of MiNT. Pressing this key once
  54.     causes a message to be printed whenever an error occurs;
  55.     pressing it twice causes a detailed trace of system calls.
  56.     This key can be *very*, *very* useful in tracking down problems
  57.     with any program!
  58. CTRL-ALT-F2: lowers the debugging level -- press it as many times as
  59.     you pressed CTRL-ALT-F1 to turn off all debugging
  60. CTRL-ALT-F3: controls where debugging output goes; press it once and
  61.     output goes to the printer, press it again and it is sent
  62.     to the RS232 port, press it again and it goes to MIDI.
  63. CTRL-ALT-F4: resets debugging output to the console
  64. CTRL-ALT-F5: shows all memory being used in the system
  65. CTRL-ALT-F6: shows all active processes in the system
  66.  
  67. CTRL-Z: suspends processes reading from/writing to the screen if the
  68.     keyboard is not in "raw" mode. Use this key only if you're
  69.     running a shell that, like you, understands job control.
  70. CTRL-ALT-Z: suspends processes reading from/writing to the screen
  71.     no matter what. The warning with CTRL-ALT-Z applies doubly here!
  72.  
  73. (8) It has been reported that MiNT works much better under TOS 1.0
  74. if FATSPEED.PRG is in the AUTO folder before it.
  75.  
  76. Other Docs:
  77.  
  78. "readme" contains a general introduction to MiNT
  79. "readme.new" summarizes the new features of this version of MiNT
  80. "copying" says under what conditions you can make copies of MiNT
  81. "toswin.doc" contains information about the background program accessory
  82. "mint.doc" contains more detailed information about MiNT, including
  83.    information of interest to programmers
  84. "features" is a list of areas where MiNT is deliberately incompatible with
  85.    TOS
  86. "bugs" is a list of known bugs in MiNT -- read this one! Also, remember that
  87.    there are lots of unknown bugs in MiNT as well.
  88. "problems" is an (incomplete) list of programs that are known to have
  89.    problems working under MiNT
  90. "faq" answers some frequently asked questions about MiNT.
  91.